Skip to content

chore: 子项目与 Agent 项目完全解耦(实体 AGENTS.md + 去掉 .pi 交叉引用) - #10

Merged
xhqing merged 1 commit into
mainfrom
chore/independent-pi-config
Nov 8, 2026
Merged

xhqing merged 1 commit into
mainfrom
chore/independent-pi-config

Conversation

@xhqing

@xhqing xhqing commented Nov 8, 2026

Copy link
Copy Markdown
Owner

起因

用户 2026-11-08 决定:Agent 项目与子项目的 AGENTS.md、.pi 目录之间完全无关——各自只放本项目真实需要的内容,不再靠软链接与路径引用互相牵连。

原来的做法是「身份层挂 AGENTS.md → ../<Agent项目>/AGENTS.md 软链接 + 能力层在 .pi/settings.json 里引用 Agent 项目的资源目录」。问题:

  • 那种引用是跨仓库隐式依赖:单独 clone、Agent 项目改名、换机器都会静默失效(pi 不报错,只是少加载东西)。
  • 子项目本可以有自己的规则与配置,却因为「两层压在一个符号上」的纪律(只允许追加、不许重述)束手束脚。

改了什么

  • AGENTS.md 由软链接改为本仓库的实体文件:写项目定位、负责 Agent、Worker 角色边界,以及各类规则的索引位置。
  • .pi/APPEND_SYSTEM.md:把描述旧软链机制的那句话改为指向本仓库 AGENTS.md 与全局 ~/.pi/agent/AGENTS.md;「你的角色」整节移入 AGENTS.md,不再两处重述。
  • .pi/settings.json:删除对 Agent 项目 extensions / skills / prompts / themes 四个目录的路径引用(该文件原本只有这四条引用,故整个删除)。.pi/{extensions,skills,prompts,themes} 本来就会被自动发现,以后本项目真的需要什么,直接放进自己目录即可。

为什么删掉这些引用没有实际损失

pi 的全局层 ~/.pi/agent/(全部团队规则、add / commit / bump / release 技能、各类守卫扩展)在任何目录都会加载,项目级交叉引用带过来的东西远少于直觉。安全网一件不少。

起因:用户 2026-11-08 决定「Agent 项目与子项目的 AGENTS.md、.pi 目录完全无关」,各自只放本项目真实需要的内容。
本次:AGENTS.md 由指向 Agent 项目的软链接改为本仓库实体文件(承载项目定位、负责 Agent、Worker 角色边界与文档索引);.pi/APPEND_SYSTEM.md 里描述旧软链机制的句子改为指向本仓库 AGENTS.md 与全局规则;.pi/settings.json 里对 Agent 项目资源目录的四条路径引用已删除(该文件原本只有这四条引用,故整个删除)。
@xhqing
xhqing enabled auto-merge (squash) November 8, 2026 14:35
@xhqing
xhqing merged commit 12a0783 into main Nov 8, 2026
1 check passed
@xhqing
xhqing deleted the chore/independent-pi-config branch November 8, 2026 14:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant